home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1993 / Internet Info CD-ROM (Walnut Creek) (1993).iso / networking / terms / tipx / README.TIPX < prev    next >
Encoding:
Text File  |  1991-10-11  |  5.2 KB  |  128 lines
  1. tipx is based on the 4.3 tip available from uunet's ftp
  2. communications subdirectory.
  3.  
  4. Two changes were added, transparent mode (called rawthru in
  5. the code) and X/Y/ZMODEM file transfer.
  6.  
  7. To make tipx, first get the basic tip distribution working, then
  8. unshar this set on top of a copy of the distribution, type
  9.    sh CONVERT2TIPX
  10. edit the Makefile to your liking, then make.  Leave -DTIPX in the CFLAGS
  11. to keep the tipx changes.  Removing -DTIPX should cause the original tip
  12. to be produced.
  13.  
  14. Typing make in the xfer subdirectory will make the two transfer programs.
  15. Place tipx, tiprz and tipsz together in reach of your $PATH to
  16. execute.  You may have to set u+s on tipx and chown to daemon,
  17. uucp or some other uid.  I have not run tipx setuid, but the same
  18. security precautions are taken with file transfer as are taken
  19. with other pertinent paths, such as shell escape, etc.
  20.  
  21. If you do not want -DACULOG, remake in libacu.  (-DACULOG is the
  22. onlything on our system which required setuid).
  23.  
  24. I make no warranties: caveat emptor, carpe diem and all that stuff.  You
  25. may wish to remove the copyright notice on startup.  It probably does
  26. not need to be there, but I am a nervous wee hacker (old definition!)
  27. and tread lightly in the land of wizards.
  28.  
  29. Transparent Pass-through
  30. ------------------------
  31.  
  32. The ~R and ~N commands were added to support transparent mode
  33. (eight-bit transmission between local and remote tty).
  34.  
  35. ~R enables transparent mode, after which all characters are
  36. passed byte-for-byte, bit for bit between the two tty ports.
  37. The sole exception is that if no input is sent by the local
  38. tty for one second, followed by three escape codes (usually
  39. tilde) within a second, followed by a second of silence, then
  40. the tip command mode is entered.  The side effect of this
  41. feature is that the first escape character passed in this
  42. window of two seconds will delay transmission for up to two
  43. seconds.  This has not been too much of a problem here.
  44.  
  45. File Transfer
  46. -------------
  47.  
  48. The file transfer mode requires the control tty to have a
  49. valid TERM environment variable since it uses a curses-based
  50. status display.
  51.  
  52. ~X enters the file transfer mode.  Viz:
  53.  
  54. ~X
  55. file transfer command? (? for help) ?
  56. for send help, type ~Xs?; for receive help, type ~Xr?
  57. where ~ represents your escape character
  58.  
  59. XMODEM (CHK, CRC) and XMODEM-1k/CRC
  60. sx [-ak] filename  -a (ASCII) convert NL to CR/LF (default binary)
  61.                    -k use 1024 blocks instead of 128 (XMODEM-1k)
  62. YMODEM/CRC Batch
  63. sy [-af] filelist  -a (ASCII) convert NL to CR/LF (default binary)
  64.                    -f transfer using full pathanme (default simple)
  65. ZMODEM (CRC-16, CRC-32)
  66. sz [-af+nNyrwo] [-w #] [-L #] [-l #]  filelist
  67.                    -a (ASCII) convert NL to CR/LF (default binary)
  68.  not all ZMODEM    -f transfer using full pathanme (default simple)
  69.  receivers accept  -+ Append to existing destination file
  70.  all overwrite     -n overwrite file if source newer
  71.  or append         -N overwrite file if source newer or longer
  72.  options           -y yes, absolutely overwrite existing file
  73.                    -r Resume/Recover interrupted file transfer
  74.                    -o use CRC-16 instead of CRC-32
  75.                    -w # Window is # bytes (>= 256, multiple of 64)
  76.                    -L # Limit subpacket length to # bytes
  77.                    -l # Limit frame length to # bytes (l must >= L)
  78.  
  79. ~X
  80. file transfer command? (? for help) r?
  81. XMODEM (CHK, CRC) (rcvr tries CRC, then checksum)
  82.                           rx [-ab] filename
  83. YMODEM/CRC Batch          ry [-abu]
  84. ZMODEM (CRC-16, CRC-32)   rz [-abu]
  85. Switches:    -a force ASCII translation on receive
  86.              -b force binary transfer
  87.              -u convert uppercase filenames to lower case
  88.  
  89. All of the switches are compatible with the rz/sz programs (1.44)
  90. by Chuck Forsberg from which these programs were derived.
  91.  
  92. The curses-based status display looks something like:
  93.  
  94.         .-[ tipsz 1.00 ]-- /u3/sd/wht -----------------------------.
  95.         |  ZMODEM/CRC32  Transfer rate ~= 319 ch/sec (33%)         |
  96.         |  File   1 of   1: mail.log                               |
  97.         |  File position:      1275 length:     1275  -rw-------   |
  98.         |  Sending 1275 bytes  total time ~=  0:02                 |
  99.         |  tx: hdr ZFIN  0             rx: hdr ZFIN  0             |
  100.         |  Comm I/O: rx      176  tx     1414 bytes                |
  101.         |  Baud rate:  9600 BINARY blklen:  1024 comm mode: NORMAL |
  102.         |  Time:    started: 18:03:04 this file: 18:03:06 window:  |
  103.         |  18:03:12 elapsed: 00:00:08            00:00:00 +0       |
  104.         |  Errors: this file:   0 total:    0 files skipped:   0   |
  105.         |  Total file bytes transferred: 1275                      |
  106.         |  End of file                                             |
  107.         |  Remote: CRC32 y  duplex y  continuous stream y          |
  108.         `----------------------------------------------------------'
  109.  
  110. away for 11 seconds
  111. !
  112.  
  113.  
  114. Enjoy,
  115.     Warren Tucker <wht%n4hgf@gatech.edu>
  116.     150 West Lake Drive
  117.     Mountain Park, GA  30075
  118.     (404) 587-5766
  119.  
  120. TODO (from Doug Kingston <dpk@morgan.com> README.SLIP)
  121.     port back to SunOS 3.5/4.2BSD environment (line discipline version)
  122.         (code is there but untested)
  123.     work on header file includes and ioctl usage
  124.         to eliminate the redefine error messages
  125.  
  126. TODO
  127.     update man pages
  128.